home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / memory & system tools / systeminfo / system information.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  52KB  |  837 lines

  1. @database "System Information.Guide"
  2. ## This is a doc file in the amigaguide.library format. Hypertext should soon
  3. ## be available on the Amiga at system level, and since the .guide format is
  4. ## perfectly humanly readable, I prefer to distribute this doc file in the
  5. ## present form. I apologize for any inconvenience; I'm convinced that in the
  6. ## long run everybody will appreciate this choice (and anyway "there is still
  7. ## time to change the road you're on"...). If you have the amigaguide.library
  8. ## keep this file in the same directory as System Information, and press the
  9. ## HELP key to get the on-line help.(Not implemented yet, sorry)
  10. ## If the help window doesn't appear, this means that amigaguide.library is
  11. ## not in the LIBS: directory, or the System Information.guide file (this one
  12. ## is not in the same directory as System Information. There is also a chance
  13. ## that you don't have enough memory.
  14. @width 77
  15. @Node Main "System Information Help"
  16.                       @{"    Background    " Link BackGround}
  17.                       @{"     Overview     " Link OverView}
  18.                       @{"   Requirements   " Link Reqs}
  19.                       @{"     Copyright    " Link CopyRight}
  20.                       @{"   Distribution   " Link Distribution}
  21.                       @{"   Registration   " Link Contribution}
  22.                       @{"   Cards Module   " Link Cards}
  23.                       @{"   Drive Module   " Link Drives}
  24.                       @{"  SysInfo Module  " Link SysInfo}
  25.                       @{"     Updating     " Link Update}
  26.                       @{"   Bug Reports    " Link Bugs}
  27.                       @{" About the Author " Link Auteur}
  28. @EndNode
  29. @Node BackGround "System Information - Background"
  30.                            @{" SYSTEM INFORMATION " link OverView}
  31.                            (SysInfo for short!)
  32.                      @{" 
  33. 1989-1991 " link CopyRight} by @{" Paul Kolenbrander. " link Auteur}
  34.                             All Rights Reserved!
  35. Thank you for obtaining SysInfo. You now have a high quality utility-program
  36. for use with the  Amiga (tm) series computer. But before you start using the
  37. program, please make a backup copy of your original disk. The software isn't
  38. copy-protected, so you can use the standard 'DiskCopy' command of your Amiga
  39. Workbench(tm) disk for this. After you've made the backup,  please store the
  40. original diskette in a safe place and, from then on, only use the backup. In
  41. case of an  accident you can always make another  backup from your  original
  42. diskette.  This program may be installed on a harddisk.  Just copy the files
  43. System_Information and System_Information.info to your harddisk.
  44.                           Current Version: 2.0a
  45. I developed this package because of the following reasons:
  46. -  I needed to find out where the BridgeBoard was configured for my CPC prog
  47.    to work properly. I was told how to do this at the '89 Cologne AmiExpo by
  48.    Mr. Lang of Commodore Germany. So I started work on it immediately and as
  49.    development proceeded I found it's potential far greater than just a tiny
  50.    hack.
  51. -  It looked like a good way to get to know my Amy better and also learn the
  52.    tricks on C programming on the old girl.
  53. Versions:
  54. November 1989: -Version 0.9. CLI-based tool, only displaying some PlugInCard
  55.                 data. I called it Boards.
  56. December 1989: -Version 1.0. I discovered it's potential and started to turn
  57.                 SysInfo, as it was called by then, into a powerful program.
  58. March    1990: -Version 1.1. Added support for the SysInfo module.
  59. April    1990: -Version 1.2. Added the Drives module.
  60. 1990  /  1991:  Added still more boards and manufacturer strings to it. Also
  61.                 several small improvements were made.
  62. November 1991: -Version 2.0. I got the Release 2 software. So now I've gotta
  63.                 make SysInfo release 2.04 compatible. So I upped the version
  64.                 number to 2.0 as well.
  65. January  1992: Released the program into SAN. And found out there were still
  66.                some small problems. Reception of it was fairly good.
  67. Februari 1992: -Version 2.0a. Added the Asl Filerequester and some more SCSI
  68.                 support. Also I made it comply better with the C= standards.
  69.                 (menu + help key)  As of version 2.0a this program is called
  70.                 System Information to avoid further confusion with 'SysInfo'
  71.                 made by Nic Wilson.
  72. This program started life as a tool called Boards.  Basically doing what the
  73. Cards module of System Information does now. From then on new functions were
  74. added until now System Information 2.0 was born.  I've made this program 2.0
  75. compatible as much as I can without having access to the docs and other info
  76. on 2.04. System Information, from now referred to as SysInfo,  it's shorter,
  77. will open on the default PublicScreen being Workbench or any other one.  The
  78. program checks if the size of that screen is at least 563 by 180 pixels.  If
  79. not, SysInfo will end since it needs a screen of at least this size. SysInfo
  80. will center its window on the screen.  It has been tested with the Enforcer,
  81. which will only hit when SysInfo tries to read any vector  pointing anywhere
  82. near the bottom of the memory map.  This is not an error!
  83. This program is intended as a handy utility to determine what is inside your
  84. Amiga. It is not meant as another of these 'SpeedInfo' tools.  I've kept the
  85. user interface as close to the Amiga interface as possible, since I  dislike
  86. programs that open their own custom screen and use yet another userinterface
  87. when it could just as well have run on the WorkBench screen, using the Amiga
  88. interface. MultTasking hasn't been implemented on the Amiga for nothing. The
  89. program will function without problems on a 4, 8 or 16 color WorkBench. With
  90. a 2 color WorkBench, you will lose some of the information. Also the gadgets
  91. will become a bit strange. If you favourite colorpalette does not agree with
  92. SysInfo, just hit RT-Amiga + P.  Then the program will modify the palette to
  93. it's own preferences.  When you  exit the program, it will of course restore
  94. your original palette.
  95. As of version 2.0a, System Information will use the Asl.library to provide a
  96. FileRequester for use with it's File-It mode. I decided on this step because
  97. Release 2 has this requester built in. There will be no effort made by me to
  98. provide a similar function for 1.3.  The reason being that there are several
  99. libraries offering this function and if I support one,  I'll undoubtedly get
  100. letters why that one, and not the other. So I've decided not to. If you wish
  101. a FileRequester, upgrade to AmigaDOS Release 2 and you'll get one.  Also the
  102. program's menu has been redone as to better comply with the Commodore stand-
  103. ards as set in the 'User Interface Style Guide' (ISBN 0-201-57757-7).  As of
  104. now, the user may also press the 'HELP' key to obtain the help screen.  (RT-
  105. Amiga + H will still perform this function as well)  This has also been done
  106. as to better comply with the above mentioned Commodore standards.
  107. @endnode
  108. @node OverView "System Information - Overview"
  109.                           First and Foremost!
  110. This program is meant as Shareware.  Meaning that when you find this program
  111. useful, you ARE morally obliged to send a US$ 15 contribution to the author.
  112. This proggy started out as FreeWare about 2 years ago. I only asked for some
  113. kind of appreciation, if only a note when you liked the program. Sofar there
  114. have been no (nada, zip) replies. So, as of now, it's ShareWare. See if this
  115. brings in some mail!
  116. I know I have no way of making you pay these 15 bucks I ask for the program.
  117. However, take heed! If nobody sends in a contribution,  I *will* assume that
  118. nobody uses the program and therefore  I cease all efforts to upgrade and/or
  119. support this program.  Furthermore, I will probably go commercial with other
  120. programs. You will have to pay a lot more then,  and you will have no way of
  121. testing it out before you pay. Finally, remember this saying:
  122.                 'It is better to give than to receive!'
  123.       (I've given you this program, so now it's you turn, isn't it?)
  124.                            Enjoy the program!
  125.                                 /-----/
  126. What does it do?
  127. There are three modules in the program. These are:
  128. - The @{" Cards " link Cards} module.
  129.    This module displays all kinds of info on the  auto-configuring boards in
  130.    your Amiga. Clicking on the Next gadget will display info on the next one
  131.    found. (Providing there are any) Clicking the (Re)Start gadget will start
  132.    again at the first board.
  133. - The @{" Drives " link Drives} module.
  134.    This module displays all kind of info on mounted disk devices.  Using the
  135.    Next and Previous gadgets will cycle you through all mounted diskdevices.
  136.    (The Cross-DOS device is supported, as well as the MessyDOS device!).This
  137.    module has a couple of hidden gadgets which are of use to users with SCSI
  138.    devices. Some of that info is also provided for other devices.
  139. - The @{" SysInfo " link SysInfo} module.
  140.    This module provides you with all kind of info on the Amiga itself. There
  141.    are a number of hidden gadgets in this window. The list of mounted drives
  142.    are gadgets. Just click on a drive name and you will find yourself in the
  143.    Drives module with info on the drive you clicked. Clicking on the SysInfo
  144.    gadget returns you to this SysInfo module.   Or use the Next and Previous
  145.    gadgets to cycle through the mounted disk devices.   Secondly, the values
  146.    behind the Cold / Coolcapture vectors, as well as the KickMem and KickTag
  147.    pointers are gadgets.  Clicking there  will give you a memorydump of that
  148.    vector. This will enable you to check for viruses, etc. The values behind
  149.    the SuperVisor stack prompts are also gadgets, which will supply you with
  150.    a memory dump. To exit the memory dump window,  just click on the SysInfo
  151.    gadget. The memorydump window features a number of gadgets that allow the
  152.    user to scroll through the Amiga memory a half- or full-page forward  and
  153.    backward. Clicking the rectangle gadget will display the inititial memory
  154.    location. Clicking on the processor type will calculate the 'approximate'
  155.    clockspeed. Recently there has been a crop of new, asynchronously running
  156.    acceleratorcards on the market. Due to that design, SysInfo cannot always
  157.    present an accurate clockspeed for these cards. Also due to the fact that
  158.    SysInfo tries to do this in an Intuitionfriendly manner,  the presence of
  159.    interrupt driven programs might present incorrect speeds.
  160. Other features:
  161. - Iconify option, Can be selected either from the menu (Rt-Amiga + I), or by
  162.   clicking the hidden gadget just under the CloseBox. It's a toggling switch
  163.   so clicking it again will bring the window back to it's full size.
  164. - Palette option. Since this program has been designed to function under the
  165.   WorkBench 2.0 O.S. which has a totally new palette, a  problem might arise
  166.   when using other palette's. Therefore, just select  PALETTE from the menu,
  167.   or press <Rt-Amiga P> and your WB screen palette will be changed to the WB
  168.   2.04 palette. To restore your original palette, just reselect this option.
  169.   Also upon exit,  the program automatically restores your original palette.
  170.   This option is compatible with 4, 8 and 16 color palette's.
  171. - File-It mode.  This will dump all the information gathered by this program
  172.   to file System_Information.FileIt on the RAM: device by default. With 2.04
  173.   you have access to the Asl filerequester and can change this. This is very
  174.   useful for keeping  configuration records, or even  debugging information.
  175.   Eg. If a program doesn't work, run System Information,  enable the File-It
  176.   mode and make a record of your system. Now you can sent this together with
  177.   your bug-report to the manufacturer.  (To dump the information on the Info
  178.   screen, use the SysInfo menu option! Switch on the File-It mode before you
  179.   reach the information you want written to the file.)
  180. How to run.
  181. CLI       Usage : System_Information or Run System_Information
  182. WorkBench Usage : Just click on the System_Information icon.
  183. Operation of the program is fairly simple. Just click on the NEXT gadget for
  184. information on the next board-entry found in the ConfigDev lists,  or on the
  185. (RE)START gadget if you want to start back at the first entry in the Config-
  186. Dev lists. Click the  SYSINFO gadget to activate the SysInfo module.  Select
  187. ABOUT, or press <Rt-Amiga A> for some information on the program. ( Same one
  188. as the Intro message!) Select HELP from the menu or press <Rt-Amiga + H> for
  189. a help screen.
  190. Selecting BRAIN or pressing <RT-Amiga +M> gives you the version of the Brain
  191. file this program contains.  In there, the descriptions  of the manufacturer
  192. and product items are kept. So far, I haven't been able to get my hands on a
  193. copy of CBM's list of  manufacturer numbers / names, or on a list of product
  194. codes / descriptions. So if you have a card in your system that this program
  195. does not display the product  description and / or the manufacturer name of.
  196. Send me a card! Write on it the number you see after the Product Code prompt
  197. as well as the name of the card. Jot down also the number you see behind the
  198. 'Manufacturer' prompt. As well as the name of the company that made the card
  199. you are talking about. If you have more than one board, and you are not sure
  200. which is which just put all the boards you have on the card. I will probably
  201. be able to sort out which is which. I am grateful for any piece of info.  Of
  202. course, if you work for Commodore, or some other firm that has access to the
  203. lists I mentioned above, I'll be even more happy with those! CATS!!! are you
  204. listening??  Click the Close-gadget to quit the program. You may also select
  205. QUIT from the menu or press <Rt-Amiga Q> to quit. To the left of the SYSINFO
  206. gadget, you will find the 'Message Box'. Here, program messages, such as the
  207. version of the 'Brain' file are displayed. This is NOT a gadget!
  208. @endnode
  209. @node reqs "System Information - Requirements"
  210.                       This program's requirements are:
  211. An A2000 or A500 with at least 1 expansion board. Otherwise the Cards module
  212. is fairly useless. This program will also work on the A1000.  As well as the
  213. A3000. It also works on a standard A500plus. (That, I tested.)
  214. This program works with WorkBench version 1.3, as well as the new WB2.04. It
  215. has not been tested with WorkBench 1.0, 1.1 or 1.2 though. 1.3 has been done
  216. by SetCPU KickROMming 1.3 over my 2.04. This is a handy way of changing Kick
  217. Start's. 1.2 would load, but would not run.  Since I think only a handful of
  218. people,  mostly game freaks, still use KickStart 1.2,  I didn't bother. They
  219. won't be interested in the program anyway. It should work though! If anybody
  220. who has access to 1.2 Amigas tries it,  could he/she please let me know what
  221. happened to the program.
  222. The disk devices RAM: and VDK: are not supported in the Drives module.  This
  223. is because of their peculiar structure,  and the lack of info on their exact
  224. workings. VD0, CrossDos & MSH are supported however. Other disk devices from
  225. Commodore, such as RAD: and CARD: are also supported.
  226. @endnode
  227. @node CopyRight "System Information - Copyright"
  228.                               Copyright.
  229. The SysInfo program is copyright 1989-91 by P. Kolenbrander.
  230. - Copying and @{" distribution. " link Distribution}
  231. This program is *NOT* Public Domain. It may be freely redistributed however.
  232. Everybody is free to make as many copies of this programs as he or she wants
  233. and distribute these copies! Since this is ShareWare, if one uses the proggy
  234. one  is morally obliged to send the author the requested contribution.  This
  235. can not be enforced, of course! I will however cease distribution of updates
  236. if no contributions are received. Since in that case nobody seems to find it
  237. a useful program.  There are but a few rules you *must* observe when copying
  238. or distributing this package. These rules are  specified a bit further on in
  239. this document. First there is an very *important* message for people in both
  240. Germany and Great Britain, as well as the Netherlands.
  241.      ==================================================================
  242.                               <<< NOTICE >>>
  243.      The above does not apply to Great Britain or Germany (BRD). Due to
  244.      the fact that a lot of 'PD-vendors' are grossly overcharging their
  245.      customers in these countries I have decided that this software may
  246.      only be distributed by appointed distributers. Any distributor who
  247.      wish to obtain a distribution license  should write to the address
  248.      mentioned in the Contributions chapter.   The distribution of this
  249.      package by usergroups and/or other users in both Great Britain and
  250.      West-Germany is of course permitted as long as there is no charge.
  251.      ------------------------------------------------------------------
  252.                               <<< ACHTUNG >>>
  253.          Vertriebsbestimmungen fuer die BundesRepublik Deutschland!
  254.        Wegen der geldgierigen Geschaeften der meisen sogenannten 'PD'
  255.        Vertreiber ist es nicht gestattet diese Software in der BRD zu
  256.        vertreiben ohne Schriftliche Lizenz.  Diese Lizenz wird nur an
  257.        Reputablen Betriebe erteilt
  258.        Diese Software darf nicht ohne vorherige Zustimmung meinerseits
  259.        auf deutschen PD-Disketten erscheinen.
  260.        Des weiteren ist der Vertrieb dieser Programme, auf Fish- oder
  261.        andere PD-Disks, von allen  deutschen 'PD-H
  262. ndlern' ohne meine
  263.        vorherige schriftliche Genehmigung ebenfalls untersagt.
  264.        Erlaubt ist nat
  265. rlich das normale Kopieren und Weitergeben von
  266.        Disketten mit System Information im nichtkommerziellen Rahmen,
  267.        also Gebuehren-frei.
  268.        F
  269. r Anfragen stehe ich unter der unten aufgef
  270. hrten Adresse zur
  271.        Verf
  272. gung.
  273.        Sollte diese software  von einer PD-Disk entfernt werden mussen
  274.        um diesen Bestimmungen nachzukommen, so mu
  275.  dieses File auf der
  276.        Disk verbleiben.
  277.        Ich unternehme diesen Schritt, da es in Deutschland  eine Reihe
  278.        'H
  279. ndler' gibt, die f
  280. r PD-Disketten wahre Wucherpreise erheben,
  281.        die keineswegs mehr durch den f
  282. r sie  entstehenden  Aufwand zu
  283.        rechtfertigen sind.
  284.        Auch wird vielen 'AMIGAnern und -innen' das Geld f
  285. r gerade mal
  286.        30-50% volle Disketten aus der Tasche gezogen.
  287.                           An den deutschen Kunden:
  288.        Sollten Sie Kunde eines deutschen H
  289. ndlers sein,  und an dieses
  290.        Paket doch  interessiert sein, so  schicken Sie mir eine  leere
  291.        Diskette mit R
  292. ckumschlag und zwei  International Reply Coupons
  293.        zu (Gibt's bei der Post). Ich kopiere ihnen das Paket gerne.
  294.      ------------------------------------------------------------------
  295.                              <<< ATTENTIE >>>
  296.                          Distributie in Nederland!
  297.      Daar er, ook in Nederland,  mensen zijn die met de distributie van
  298.      ShareWare(PD) goed geld verdienen, maar de originele auteurs ervan
  299.      volledig in de kou laten staan, (De door de auteur gevraagde somma
  300.      voor de contributie wordt meestal niet eens voldaan!!) is het niet
  301.      toegestaan deze software te verspreiden zonder dat hiervoor vooraf
  302.      een distributie licensie van de auteur is verkregen. Natuurlijk is
  303.      het wel toegestaan dit programma vrij te kopieren, mits dit tussen
  304.      gebruikers onderling of in user-groepen gebeurt. Natuurlijk zonder
  305.      dat hier kosten aan zijn verbonden!
  306.                       Aan de Nederlandse gebruikers:
  307.      Als U in dit programma bent geinteresseerd stuur dan een lege disk
  308.      met gefrankeerde- en aan uzelf geaddresseerde retour envelop.  Het
  309.      programma kopieer ik er dan voor U op.
  310.      ==================================================================
  311. @endnode
  312. @node Distribution "System Information - Distribution"
  313.                              Distribution.
  314. Distribution rights are hereby, of course [*;-)], granted to the SAN Network
  315. and any other non-profit organisation. People wanting to include this proggy
  316. on any disk retailing over US$ 5.00, or it's equivalent in another currency,
  317. must first obtain  written permission for this from the author.  Nor may the
  318. program be bundled with any commercial package, be is hardware, software, or
  319. a combination of both,  without also first obtaining written permission from
  320. the author of this program.
  321.      When copying and or distributing this software, you must adhere to
  322.      these few rules.
  323.      - This package may not be used by, or bundled with, any software /
  324.        hardware retailing over: (Europe) Dfl. 5.-,  (Rest of the world)
  325.        US$  5.- or it's equivalent in any other currency, without prior
  326.        written permission from the author.
  327.      - This document file must always accompany the program.
  328.      - This document file may not be modified by anyone.
  329.      - The author retains the right to forbid anyone to distribute this
  330.        software when the author suspects foul play!   Distributing this
  331.        software implies that you respect this right and will adhere  to
  332.        it.
  333.      - The author *retains* the right to *remove* this program from the
  334.        ShareWare pool at any time, without prior notification.
  335. @endnode
  336. @node Contribution "System Information - Registration"
  337.                               Registration.
  338. If you register this program, you will receive a version of the program that
  339. does not have the little Reminder Window when you exit it, and is registered
  340. in your name. Registered users will be the first to be notified, through the
  341. electronic mail of upcoming updates of the program. They may @{" upgrade " link Update} their
  342. version at a nominal cost.  At the end of this chapter you will find a form.
  343. Please complete it and sent it in if you wish to register the program.  Read
  344. on for information on the registration fee.
  345.      The registration fee for System Information is as follows:
  346.                +---------------------------------------+
  347.                |         REGISTRATION AMOUNTS          |
  348.                |                                       |
  349.                | Nederland         Dfl 25,-            |
  350.                | Rest of Europe    US$ 15,- / Dfl 30,- |
  351.                | Rest of the World US$ 15.- / Dfl 30.- |
  352.                |                                       |
  353.                +---------------------------------------+
  354.          Payment can be effected in one of the following ways:
  355.   --------------------------- NEDERLAND ----------------------------
  356.   1)  Maak fl. 25,- over op een van de volgende rekeningen, ten name
  357.       van Paul Kolenbrander.
  358.       BANK: 86.03.24.362 (VSB)     POSTGIRO: 4005686
  359.   2)  Stuur een Eurocheque of Girocheque t.w.v. fl. 25,- naar onder-
  360.       staand adres. Vergeet het pasnummer niet. ;-)
  361.   ----------------------------- EUROPE -----------------------------
  362.   1)  Send a Eurocheque for the amount of Dfl 30 to the address ment
  363.       ioned below. Don't forget the card number. ;-)
  364.   2)  Send me a Postal Money Order for the amount of Dfl 30.
  365.   3)  For all those PostGiro enthousiasts out there! My Giro account
  366.       number is 4005686 (Paul Kolenbrander) (Amount -> Dfl 30,-)
  367.   4)  Transfer US$ 15 or DFl 30 to my bankaccount Nbr.: 86.03.24.362
  368.       at the Verenigde Spaarbank Netherlands (VSB).
  369.   5)  Send me US$ 15.- in bills. (Good ol' greenbacks.)
  370.   ------------------------------ WORLD -----------------------------
  371.   1)  Send me US$ 15.- in bills. (Good ol' greenbacks.)
  372.   2)  Send me a Postal Money Order for the amount of Dfl 30.
  373.   3)  Transfer US$ 15 or DFl 30 to my bankaccount Nbr.: 86.03.24.362
  374.       at the Verenigde Spaarbank Netherlands (VSB).
  375.   4)  Send a Eurocheque for the amount of Dfl 30 to the address ment
  376.       ioned below. Don't forget the card number. ;-)
  377.   5)  For all those PostGiro enthousiasts out there! My Giro account
  378.       number is 4005686 (Paul Kolenbrander) (Amount -> Dfl 30,-)
  379.                 (No personal, or other checks please!)
  380.   ------------------------------------------------------------------
  381. My address is: P. Kolenbrander
  382.                (Paul Kolenbrander Software)
  383.                Turfveldenstraat 37
  384.                NL-5632 XH  EINDHOVEN
  385.                HOLLAND
  386. I can be reached electronically at one of the following addresses.
  387. FIDO     : 2:284/1.10 Paul Kolenbrander
  388. INTERNET : boinger@comsat.gna.tfd.com
  389.  After your contribution has been received,  you then will be sent a copy of
  390. the program registered in your name, without the Reminder Window.  This copy
  391. may *not* be distributed.  Failure to comply with this,  will result in your
  392. registration being cancelled and you will not be eligable for updates.
  393.                 Click here to see the registration form.
  394.                           @{" REGISTRATION FORM " link RegForm}
  395.                (Can be sent by mail or in electronic form)
  396. @endnode
  397. @node RegForm "System Information - Registration Form" 
  398. +----------------------------------------------------------------+
  399. |                      REGISTRATION FORM                         |
  400. +----------------------------------------------------------------+
  401. | Program     : SysInfo         Version     : 2.0                |
  402. +----------------------------------------------------------------+
  403. | NAME        :                                                  |
  404. | ADDRESS     :                                                  |
  405. | CITY        :                                                  |
  406. | COUNTY      :                                                  |
  407. | COUNTRY     :                                                  |
  408. | PHONE-NUMBER:                             (Voice/Data)*        |
  409. | E-MAIL ADDR.:                                                  |
  410. | (NETWORK)   :                                                  |
  411. |                                                                |
  412. | By sending in this registration, I agree to abide by the terms |
  413. | as specified in the SysInfo.Doc document.                      |
  414. |                                                                |
  415. | Signature:                       Date  :                       |
  416. |                                  Place :                       |
  417. |                                                                |
  418. |                                  * Tick the appropriate please |
  419. |                                                                |
  420. | ...............................                                |
  421. +----------------------------------------------------------------+
  422. | Sent to  :  P. Kolenbrander                                    |
  423. |             <Registration SysInfo V2.0>                        |
  424. |             Turfveldenstraat 37                                |
  425. |             NL-5632 XH  EINDHOVEN                              |
  426. |             The NETHERLANDS                                    |
  427. |                                                                |
  428. | FIDO     : 2:284/1.10 Paul Kolenbrander                        |
  429. | INTERNET : boinger@comsat.gna.tfd.com                          |
  430. +----------------------------------------------------------------+
  431. @endnode
  432. @node Bugs "System Information - Bug Reports"
  433.                                 Bug Reports.
  434. Accidents will happen and I'm only human. If you find a bug or you think you
  435. might have found a bug, please  print out the following form on you printer,
  436. fill in the  neccessary details, and sent it to the address mentioned on it.
  437. Thanks!
  438. Bug fixes:
  439. - As of this version a number of Device Format and Device Geometry parameter
  440.   values are shown for SCSI devices. Also Disconnect status is shown.
  441. - Program accounts for system fonts other than Topaz 8 being used.  Although
  442.   internally it will still use the Topaz 8 font. 
  443. - Problems with recognizing SCSI devices on the A3000 should now be solved.
  444. Known Problems:
  445. - Detection of ECS / Non-ECS Agnus and Denise chips isn't 100%. This problem
  446.   is being looked at.
  447. - The processor's clockspeed isn't always correct.  Since I consider it more
  448.   a toy than a useful feature,  it will be removed when it's space is needed
  449.   or enough (Registered) users ask for this. 
  450.                   Click here for the @{" Bug Report Form. " link BugForm}
  451. @endnode
  452. @node BugForm "System Information - Bug Report Form"
  453. +----------------------------------------------------------------+
  454. |                           BUG Report                           |
  455. +----------------------------------------------------------------+
  456. | Program     : SysInfo         Version     : 2.0                |
  457. |                               Brain file  :                    |
  458. +----------------------------------------------------------------+
  459. | Bug         :                                                  |
  460. |                                                                |
  461. |                                                                |
  462. |                                                                |
  463. |                                                                |
  464. |                                                                |
  465. |                                                                |
  466. +----------------------------------------------------------------+
  467. | Additional information                                         |
  468. | Error code  :                                                  |
  469. |                                                                |
  470. |                                                                |
  471. |                                                                |
  472. |                                                                |
  473. |                                                                |
  474. |                                                                |
  475. +----------------------------------------------------------------+
  476. | Sent to:    P. Kolenbrander                                    |
  477. |             <BUG-Report SysInfo V2.0>                          |
  478. |             Turfveldenstraat 37                                |
  479. |             NL-5632 XH  EINDHOVEN                              |
  480. |             The NETHERLANDS                                    |
  481. |                                                                |
  482. +----------------------------------------------------------------+
  483. @endnode
  484. @node Cards "System Information - Expansion Card module"
  485.                  Displaying Expansion-card information.
  486. To display  information on expansion-cards  that are present in your system,
  487. select the option Boards from the menu. You may also press Rt-Amiga + B. You
  488. are now in cards display mode.  Using the 'Next' gadget you can display info
  489. on the next card found.  If there are no  (more) cards  found an appropriate
  490. message is displayed in the 'Message display' at the bottom-left part of the
  491. screen.  The 'Next' gadget is then disabled.  To re-enable this gadget or to
  492. start at the first expansion-card again, click on the (Re)Start gadget.
  493. Information on the Expansion-card display.
  494. ------------ This is an example made by the the File-It option -------------
  495.                            Board : 1
  496.          TECHNICAL SPECIFICATION
  497. Config Device : 3024            / 0xbd0
  498. Product Code  : 81         A2630 68030 board & RAM expansion
  499. Manufacturer  : 514         Commodore West Chester
  500. Serial Number : 0
  501.          BOARD SPECIFICATIONS
  502. Board not chained.               Board has no space preference.
  503. Has no ROM Diagnostic vector.    CONFIGME bit still set.
  504. Board added to memory free list. SHUTUP bit cleared.
  505. Memory Size : 4 MByte.           Board cannot be shut up.
  506.                                  Board Type: Zorro II standard.
  507.          MEMORY SPECIFICATION
  508.                                  Driver        : 0       / 0x0
  509. Slot Address   : 32     / 0x20   Board Address : 2097152 / 0x200000
  510. Slot Size      : 64     / 0x40   Board Size    : 4194304 / 0x400000
  511. ------------ This is an example made by the the File-It option -------------
  512. Technical Specifications.
  513. Config Device   - This is the address where the ConfigDev structure off this
  514.                   particular card  is located.  The information shown on the
  515.                   screen is found partly in this structure.  It is also used
  516.                   by AmigaDOS.  Click on the first (decimal) value to obtain
  517.                   a memory dump of that location.
  518. Product Code    - This number is assigned to this card by it's  manufacturer
  519.                   and is used,  together with the Manufacturer to identify a
  520.                   card.
  521. Manufacturer    - This number is assigned by Commodore in  West Chester to a
  522.                   manufacturer. Together with the  'Product Code'  it can be
  523.                   used to locate a specific card. and it's associated data.
  524. Serial Number   - An optional serial number  that can be put on this card by
  525.                   the manufacturer.  So far I haven't encountered many cards
  526.                   utilizing this field.
  527. Board Specifications.
  528. Chain - Specifies if this card is    Space - Indicates  if this  board wants
  529.         physically linked to the             to be in the 8 Meg memory space
  530.         next one. Used in most               or has no specific preference.
  531.         2,4,6,8 Meg Memory cards.
  532. ROM   - Give the vector for a        Config- Shows the status of the Config-
  533.         diagnostic ROM if the card           Me bit.
  534.         has any.
  535. Free  - Tells the Amiga if this      Shutup- Shows the status of the ShutUp
  536.         card's memory should be              bit.
  537.         added to the free memory
  538.         list or not.
  539. Size  - The (memory)size of this     Shut  - Tells the  Amiga if  this  card
  540.         card.                                can be shut up or not.
  541.                                      Type  - Tells the 'type' of the card. 2
  542.                                              and 3 are the *only* card types
  543.                                              which are currently in use.
  544. Memory Specifications.
  545. (All values are represented in both decimal and hexadecimal form.)
  546. Slot Address   - The address of the slot where this card is located. (A slot
  547.                  is 64K in size)
  548. Slot Size      - The number of slots this card occupies.
  549. Board Address  - The address where this card is located at.
  550. Board Size     - The size of this card.  Basically the same info as the slot
  551.                  values only converted to memory locations.
  552. Driver         - If not 0 this points to the address where this card's driv-
  553.                  er code is located. Click on address to show a dump of it.
  554. @endnode
  555. @node Drives "System Information - Drives module"
  556.                      Displaying Drives information.
  557. To display detailed information on  mounted disk  devices, please select the
  558. drives option from the menu. You may also press Rt-Amiga + D. You are now in
  559. Drives display mode. Using the 'Previous' and 'Next' gadgets, you can browse
  560. both backward and forward through the list of mounted drives.(No information
  561. is available on RAM: and VDK:. This is due to their nature)
  562. Information on the Drives display.
  563. ------------ This is an example made by the the File-It option -------------
  564.                          Drive : DH0
  565. Heads         : 4             Low  Cylinder : 1
  566. Blocksize     : 512           High Cylinder : 854
  567. Sectors/Block : 1             Buffers Used  : 32
  568. Blocks/Track  : 42            Memory Type   : 0 Any Memory
  569. Reserved      : 2             Max. Transfer : 2147483647
  570. Pre-Allocated : 0             Boot Priority : -10
  571. InterLeave    : 0             DOS Type      : 0x444f5301
  572.                                               Fast FileSystem
  573. Handler       : gvpscsi.device
  574. Mask Value    : 0xfffffffe
  575. Unit Number   : 0              ** DRIVE/PARTITION STATUS **
  576. Device Flags  : 0              Drive Size    : 70.1 MByte
  577.                                # of Blocks   : 143472
  578.                                # of Cylinders: 854
  579. ------------- This is an example made by the the File-It option ------------
  580. Heads         : Shows the number of heads. Typically two in case of a floppy
  581.                 drive.
  582. BlockSize     : The number of bytes that make up a disk block.
  583. Sectors/Block : The number of sectors in a block. (Currently unused)
  584. Blocks/Track  : The number of blacks that make up a track.
  585. Reserved      : Number of blocks that are reserved.  In the case of a floppy
  586.                 disk this is the bootblock which is two blocks in size.
  587. Pre-Allocated : Pre-allocated blocks by the system. Mostly for directory in-
  588.                 formation.
  589. Interleave    : The interleave factor that tells the sequence of the blocks.
  590.                 Used mostly on harddisks.
  591. Drive Size    : The total available space on the disk device,  including all
  592.                 reserved and pre-allocated blocks. Calculated using the fol-
  593.                 lowing formulae:  "Blocks / Track" * "BlockSize" * "Heads" *
  594.                 (("High Cylinder" - "Low Cylinder") + 1)
  595. Handler       : Contains the name of the handler that runs this device.
  596.                 Click on it and if the device is a SCSI type device you will
  597.                 get some more information on it. For non SCSI types, you may
  598.                 also click here, but you will only get the version number of
  599.                 the handler. Beware however. Some devices although not being
  600.                 SCSI, behave like it and could cause the program to crash. I
  601.                 found that the ramdisk.device did this. SysInfo can now cope
  602.                 with this device. If you find any others, please let me know
  603.                 and I will perservere to let SysInfo cope with these too. It
  604.                 might be possible that you will see a message No SCSI device
  605.                 on bus. And shortly after SCSI information is displayed. The
  606.                 Supra Version III SCSI controller seems to suffer from this.
  607.                 It seems that somehow it configures a LUN on every available
  608.                 (being 0-6) device.
  609. Mask Value    : The address  mask that specifies  the memory range  that DMA
  610.                 transfers can use. Used with the FastFileSystem.
  611. Unit Number   : The unit number of the device.
  612. Device Flags  : Used by AmigaDOS for the OpenDevice() call. Usually 0.
  613. Low Cylinder  : The starting cylinder to use.
  614. High Cylinder : The ending cylinder to use.
  615. Buffers Used  : Number of cache buffers used by this device.
  616. Memory Type   : The type of memory used for the cache buffers.
  617. Max. Transfer : The maximum number o blocks that can be transferred at once.
  618.                 For use with the FastFileSystem.
  619. Boot Priority : This value  sets the boot priority of the disk device.  This
  620.                 can range from -129 (Not Bootable) to 127.
  621. DOS Type      : Indicates the file system used by this disk device.
  622. ------------- This is an example made by the the File-It option ------------
  623.               **SCSI Device hardware information**
  624. Board        : 0     Drive: DH0      Media is non-removable.
  625. Device       : 0   Direct Access Device (Magnetic Disk)
  626. LUN          : 0
  627. Vendor       : QUANTUM
  628. Product      : LP105S 910109405
  629. Revision     : 3.1
  630. Device Driver: v3.15 -- gvpscsi 3.15 (25 Jul 1991) Ralph Babel
  631. *This SCSI Device supports the following SCSI standards*
  632. ANSI version : 2    ECMA version : 0    ISO  version : 0
  633. *This SCSI Device supports the following options:*
  634. Synchronous data transfers supported.
  635. Linked commands are supported.
  636. Device uses hard resets.
  637. ------------ This is an example made by the the File-It option -------------
  638. The above example displays the extra information you can get on a SCSIdevice
  639. when you click the 'handler' name in drives module. If you click the Product
  640. name, (in this case LPS105) you'll get the contents of page 0 (hardware info
  641. contained in the SCSI device.) Getting this info depends on your controller/
  642. SCSI device combination. Not all controllers, or devices for that matter, do
  643. indeed provide support for this mode.
  644. If you click on the Vendor, (For this device Quantum) you will get some more
  645. information on the device's geometry and format parameters.
  646. ------------ This is an example made by the the File-It option -------------
  647. ** Device Format and Geometry Parameters **
  648. * Device Format Parameters *   * Drive Geometry Parameters *
  649. Page length          : 22      Page length          : 18
  650. Tracks per Zone      : 4       Number of Cyls       : 1219
  651. Altern. Sectors/Zone : 1       Number of Heads      : 4
  652. Altern. Tracks/Zone  : 0       Write PreComp at     : 0
  653. Altern. Tracks/Volume: 0       Reduced Write at     : 1229
  654. Sectors per Track    : 49      Drive Step rate      : 0
  655. Bytes per Sector     : 512     Landing zone         : 0
  656. Interleave           : 1
  657. Track Skew factor    : 9       Disconnection   : Enabled
  658. Cylinder Skew factor : 18
  659. * Inquiry SCSI Device Page 0 *
  660. 00000201 7d000018 5155414e 54554d20 4c503130  ....}...QUANTUM LP10
  661. 35532039 31303130 39343035 332e3120 30332f31  5S 9101094053.1 03/1
  662. 342f3931 36313038 32373037 32342020 00000000  4/916108270724  ....
  663. 00000000 00000000 00000000 00000000 00000000  ....................
  664. 00000000 00000000 00000000 00000000 00004745  ..................GE
  665. 4e455249 43202020 20202020 20202020 20202020  NERIC
  666. 4e455249 43202020 20202020 20202020 20202020  NERIC
  667. ------------- This is an example made by the the File-It option ------------
  668. @endnode
  669. @node SysInfo "System Information - SysInfo module"
  670.                       Displaying SysInfo Information.
  671. Show information on the system such as processor type, video mode, amount of
  672. memory, mounted drives etc. This display contains a number of hidden gadgets
  673. that may be used to access more detailed information. Click on the name of a
  674. mounted drive, eg. DF0: and the  Drives display  becomes active.  Use either
  675. the 'Previous' and 'Next' gadget to look at other mounted drives or click on
  676. the 'SysInfo' gadget to activate the  SysInfo display.  To see a memory dump
  677. of that specific address, just click on the values behind the 'Stack lower',
  678. 'Stack upper', 'ColdCapture vector',  'CoolCapture vector',  'KickMemPtr' or
  679. 'KickTagPtr'.  The Memory Dump display is now activated.  In the upper right
  680. corner of this display  five gadgets  are displayed.  Their functions are as
  681. follows, from top to bottom:  Display previous 256 Bytes (Page Up),  Display
  682. previous 128 Bytes (Halfpage Up),  Go to original address,  Display next 128
  683. Bytes (Halfpage down) and Display next 256 Bytes. (Page Down).  Click on the
  684. 'SysInfo' gadget to return to the SysInfo display.
  685. ------------ This is an example made by the the File-It option -------------
  686.                       System Information
  687. Processor         : 68030         Video Mode : PAL  / 50Hz
  688. Co-Proc. (FPU/MMU): 68882/68030   VBlank Frq :        50Hz
  689. Agnus chip type   : ECS Agnus
  690. Denise chip type  : ECS Denise    >> SuperVisor Stack <<
  691. KickStart version : 37.175        Stack size : 6144/ 0x1800
  692. WorkBench version : 37.67         Stack Lower: 2099720 / 0x200a08
  693. A.R.P. version    : 39.1          Stack Upper: 2105864 / 0x202208
  694. ColdCapture Vector: 0x0           KickMem Ptr: 0x0
  695. CoolCapture Vector: 0x0           KickTag Ptr: 0x0
  696. Memory Type       : Maximum    Free         In-Use     Largest
  697. CHIP Memory         1048576    840272      208304    785800
  698. FAST Memory         8388576    7281744      1106832    6873056
  699. ** Found the following mounted drives: **
  700. DF0: DF1: DF2: DH0: DH1: DH2: DH3: RAM: IBMA VD0: VDK: RAD:
  701. ------------ This is an example made by the the File-It option -------------
  702. Information on the SysInfo display.
  703. Processor         : The processor type curently used in your Amiga.
  704.                     (Clicking on this will freeze op your Amiga for a couple
  705.                     of seconds  and will then  tell you the  clockspeed that
  706.                     the processor is running at.)
  707. Co-Processor      : The type of mathematical co-processor used, if any. Here
  708.                     also is  displayed the type of MMU present.  Please note
  709.                     that the MC68030 has a MMU built in. An 68EC030 has not.
  710. Agnus chip type   : Type of Agnus chip. Either Agnus chip (A500/A1000/A2x00)
  711.                     or ECS Agnus chip (Newer A500/A2x00/A3000).
  712. Denise chip type  : type of Denise chip.  Either Denise  (A1000/A500/A2x00),
  713.                     or ECS Denise. (A3000)
  714. KickStart version : The version number of the kickstart.(32 - 1.1 / 33 - 1.2
  715.                     /34 - 1.3 / 35 - 1.4 / 36 - 1.9 / 37 - 2.0 / 38 - 2.1)
  716. Workbench version : The version number of the Workbench. (See above.)
  717. A.R.P. version    : The version of ARP, the Amiga Replacement Project.
  718.                     As of 2.0, parts of this is incorporated in the asl
  719.                     library, which is part of 2.0.
  720. ColdCapture vector: If not 0x0,  there might be a resident program out there
  721.                     It may be harmless like SetPatch or it might be a virus.
  722.                     Click on the value to get a memory dump.
  723. CoolCapture vector: If not 0x0,  there might be a resident program out there
  724.                     It may be harmless like SetPatch or it might be a virus.
  725.                     Click on the value to get a memory dump.
  726. Video Mode        : Determines if this is a PAL or an NTSC system. (PAL uses
  727.                     50HZ and NTSC 60Hz)  SysInfo always checks the hardware.
  728.                     So with 2.0 it doesn't matter what the software says. If
  729.                     your Amiga is hardwired for PAL,  SysInfo will say it is
  730.                     a PAL system. If hardwired for NTSC, SysInfo will say it
  731.                     is an NTSC system.
  732. VBlank Frq.       : The VerticalBlank frequency. From here the Amiga is able
  733.                     to obtain its video synchronisation.
  734. Screen Width      : The width of the screen on which  SysInfo has opened its
  735.                     window. Is mainly of use for 2.0 Amiga's.
  736. Screen Heigth     : The height of the screen on which SysInfo has opened its
  737.                     window. Is mainly of use for 2.0 Amiga's.
  738. Stack size        : The size of the Supervisor stack used by the system.
  739. Stack lower       : The lower address of the Supervisor stack.
  740. Stack upper       : The upper address of the Supervisor stack.
  741. KickMem Pointer   : If not 0x0,  there might be a resident program out there
  742.                     It may be harmless like SetPatch or it might be a virus.
  743.                     Click on the value to get a memory dump.
  744. KickTag Pointer   : If not 0x0,  there might be a resident program out there
  745.                     It may be harmless like SetPatch or it might be a virus.
  746.                     Click on the value to get a memory dump.
  747. Memory Display    : Displays the amount of memory available, free, in-use
  748.                     and the largest free chunk available for both chip- and
  749.                     fast memory (if any!).
  750. Mounted Drives    : Shows the user which mounted disk devices were found.
  751.                     Click on any of these for more information.
  752. @endnode
  753. @node Update "System Information - Updates"
  754.                                Updates.
  755.  Updates of the program will firstly be made available to registered users.
  756. They will be supplied at cost.  Notification of any updates will be sent by
  757. electronic mail. Users who wish to update their program after they received
  758. notification should follow this procedure:
  759. If you live in the NETHERLANDS!
  760. - Stuur een diskette in een (voldoende) gefrankeerde retourenvelop voorzien
  761.   van uw naam naar bovenstaand adres.  U ontvangt dan de update per kerende
  762.   post.
  763. If you live in the REST OF THE WORLD!
  764. - Send me a diskette and a selfadressed envelope as well as either US$ 1.-,
  765.   Dfl. 2,00  or two new 3.5 floppydisks to cover postage.  You will receive
  766.   the update by return mail.
  767. The frequency of updates will be decided by YOU!, the user. Since I am fully
  768. dependent on you, sending in data about boards  that System Information does
  769. not yet recognize.  As soon as a sufficient number of manufacturers / boards
  770. have been processed, an update will be published.  This update will first go
  771. to registered users and +/- 45 days later, an update containing the Reminder
  772. Window, will be hatched on SAN, or other network.
  773. Sofar the program recognizes most of Commodore cards, as well as a number of
  774. other cards.  The program tries to determine the type of a card if it cannot
  775. recognize its Manufacturer or Product Code. Sofar it will recognize most RAM
  776. expansions and harddisk controllers this way.  Sofar I have not been able to
  777. obtain the list of  Manufacturers.  So, if you own a card that this  program
  778. doesn't recognize, or determines wrong, please let me know.  Just write that
  779. card's Product Code and Manufacturer values on a card, as well as the card's
  780. manufacturer and it's description and send it to the following address.
  781. Paul Kolenbrander Software
  782. <Expansion-card info>
  783. Turfveldenstraat 37
  784. NL-5632 XH  EINDHOVEN
  785. The NETHERLANDS
  786. Or try one of the following Electronic Mail addresses.
  787. FIDO     : 2:284/1.10 Paul Kolenbrander
  788. INTERNET : boinger@comsat.gna.tfd.com
  789. If the Brain File has been  updated with a sufficient number of Manufacturer
  790. / Product Code combinations to warrant an update, I will make available this
  791. update available through SAN or other network.
  792. @endnode
  793. @node Auteur "System Information - About the author"
  794.                      Some Information about the author.
  795.                   (But first, a message from our sponsor!)
  796.                                   NOTICE:
  797. This software is  supplied as is, and neither the author nor the distributor
  798. is liable or responsible for any damage to either the computer, pheripherals
  799. or media this software is used on. Neither the author nor distributor can be
  800. held responsible for any other damage arising from the usage of the software
  801. or arising from the software failing to operate in the manner desired by the
  802. user. Neither the author nor the distributor will be liable in any event for
  803. any loss of profits or savings. No warranty of any kind, either expressed or
  804. implied is made by the author or the distributor.
  805.                               About The Author.
  806. I used to be a systemanalist/programmer for mini's and did some work for MSD
  807. (Philips Medical Systems) as well as some other companies. I got a bit bored
  808. with life in the fast lane (Working on For Hire basis at a Service Buro), so
  809. I switched over to sales at a plastics company.  I kept on programming in my
  810. spare time as a hobby. This isn't my only work.  Some others are PicView and
  811. PicFind as well as SmusCopy, SmusInfo, MakeCopy and MakePlay.  From me also:
  812. DInfo, MAvail and Jump.  Another project that I am  currently  working on is
  813. named Easybase. A simple two field database for uses such as a phonebook, or
  814. a network username/address file. It has ToneDial capability.  So I use it as
  815. sort of a super memory phone (>1000 entries possible).  Just hold your phone
  816. receiver at the Amiga speaker (eg. monitor or A10) and select dial. Amy will
  817. then generate the required tones.
  818. If you think I deserve more then US $15,-. Well, sportscars (Preferably a 65
  819. Corvette or a Lamborghini Countach) as well as pretty daughters/sisters (The
  820. 'Kelly Bundy' type. [WITH a functioning brain, though!]) are always welcome.
  821. You'll find the address mentioned below. I could also use an A3000T (PV?) or
  822. other nice goodies...
  823. Complaints, comments and improvements to the program ( possibly with example
  824. C source! ) as well as gifts are welcome. Please direct them to one of these
  825. adresses:
  826. The address is: Paul Kolenbrander
  827.                 (Paul Kolenbrander Software)
  828.                 Turfveldenstraat 37
  829.                 NL-5632 XH  EINDHOVEN
  830.                 HOLLAND
  831.      I can be reached electronically at one of the following addresses.
  832.                   FIDO     : 2:284/1.10 Paul Kolenbrander
  833.                   USENET/  : boinger@comsat.gna.org
  834.                   INTERNET : boinger@comsat.hacktic.nl
  835.        >>> Flames and insults kindly direct to the NIL: device! <<<
  836. @endnode
  837.